As the title suggests, this is an add-on applescript for ircle. We of the SLF (if you must know: SLF = Semiconcious Liberation Front) found that ircle really sucked hard compared to ircii and decided to at least make our lives easier by writing a script to do some of the more commonly used activities.
We strongly recommend that you read this entire document BEFORE using the script. Its very straightforward and will save us a lot of e-mail questions. Please send all bug reports and suggestions to slf@xeo.net. Thank you.
- The SLF Internet Assault Team
INSTALLATION INSTRUCTIONS
1. Drop the included osax (ACME Script Widgets) in your scripting additions
folder. The scripting additions folder is located in the extensions
folder on your boot drive. You will have to reboot after this.
2. Drop the all the scripts into your ircle scripts folder. The scripts
folder is set in the scripts section of the ircle preferences. If there
are duplicates (there probably will be) move the default ones to a different
folder or just overwrite them. If you are using an old version of LSD, THROW OUT
YOUR OLD LSD PREFS FILE. It can be found in your preferences folder as "LSD Prefs".
3. Inside ircle type: /load lsd
If this is the first time you've ever loaded the script, it will ask you
a few one time only questions, and then save your ansers to its prefs.
If you later change your mind about what you entered, you can use /setval to modify
any of these values.
LSD is now installed and running. Ain't that just a trip in itself... =)
COMMAND SYNOPSIS (a.k.a what the fuck does it do?)
LSD supports the following commands:
(you can also access all this information via the /lsdhelp command)
Syntax diagram:
< > = required element
( ) = optional element
| = OR symbol
User Commands:
m: send a message to <nick>
Usage: /m <nick> (content)
j: join <channel>
Usage: /j <channel>
n: send a notice to <nick> or <channel>
Usage: /n <nick | channel> (content)
p: /cping <nick | channel>. Used with no parameters it defaults to
pinging the current channel.
Usage: /p <nick | channel>
l: leave <channel>
Usage: /l <channel>
v: Request ctcp VERSION information from <nick> or <channel>. Used
with no parameters it defaults to versioning the current channel.
Usage: /v <nick | channel>
w: list people on <channel>
Usage: /w <channel>
wi: get whois info on <nick>
Usage: /wi <nick>
ww: get whowas info on <nick>
Usage: /ww <nick>
gone: set /away with (message)
Usage: /gone (message)
back: return from being away with (message)
Usage: /back (message)
Note: The awaylog is stored in your preferences folder as "LSD
Awaylog"
Operator Commands:
k: kick <nick> or all users matching the wildcard string
<nick!user@host> from current channel.
Usage: /k <nick | nick!user@host> (reason)
b: ban <nick> or nick!user@host from current channel
ban is much more intelligent than the normal ircle *!user@host in
that it takes the following hostmasks.
For unresolved ips (i.e xxx.yyy.zzz.qqq) *!*user*@xxx.yyy.zzz.*
For resolved ips (i.e whatever.etc) *!*user*@*.whatever.etc
Usage: /b <nick | nick!user@host>
bk: ban and kick <nick> from current channel
Uses the same algorithm as the ban function but also kick the user.
Usage: /bk <nick>
wk: Add word to wordkick list
Usage: /wk <word>
rwk: remove word from wordkick list
Usage: /rwk <word>
wkl: display wordkick list
Usage: /wkl
dop: deop <nick(s)>
Usage: /dop <nick(s)>
XDCC Commands:
If you wish to offer take note:
To ensure the script lists the correct folder the value of
the script variable offer path should match the offering
folder set in your ircle prefs. If it doesn't you can
set the value of the offer path using /setval. (see description
of /setval below)
To offer files:
Place all the files you wish to offer in the offering folder.
Please make sure that there are no custom icons or invisible
files or folders inside this folder. They really screw things
up and you will be notified in the /plist.
To add comments:
Simply add a finder comment to the file. It will be added to the
plist immediatly following the file it is associated with.
To set the auto-list time:
Use /setval 5. Setting this value to 0 will turn off auto
plisting. (This is also the default)
Slots and slot expiry:
Since ircle offers absolutly no access via applescipt to any of the
xdcc variables I wrote a kludge to simulate slots. Slots will be
filled up to capacity upon which no further xdcc transfers will
be started until a slot is freed. The default starting amount of
slots is 12.
Slots are freed at a constant interval in minutes. This interval
is set in the script preferences via /setval and /values (read the
misc commands section further down for details). The default value
is 1 minute, which essentially disables the slot feature since most
transfers take slightly longer than 1 minute... =)
What value you set this to is really dependant on what you are
offering and what your connection speed is.
xl: xdcc list <nick> or <channel>. If no argument is given defaults
to listing the current channel. xl uses a more intelligent xdcc
algorithm for channel listing in that it only list those nicks
that contain either "dcc" or "ctcp".
Usage: /xl (nick | channel)
xs: request pack n from <nick>
Usage: /xs <nick> <pack #>
plist: send packs offered list to current channel
Usage: /plist
xsave: save all xdcc values to disk for later retrieval
Usage: /xsave
Note: XDCC Preferences are stored in the file LSD XDCC Save
preferences folder.
xrehash: rebuild the xdcc offer list.
You MUST do an xrehash if you change anything in the offer folder
while the script is loaded.
Usage: /xrehash
War Commands:
tsunami: dump the tsunami string to <nick>
Usage: /tsunami <nick>
f: flood <nick> with various types of nuisances.
Usage: /f <nick> <number of times> <type>
Valid types are version, ping, send and list
Misc Commands:
values: display the current values of all script variables
Usage: /values
setval: set the value of a script variable
Usage: /setval <item number>
Note: use /values to get a list of avaliable items
save: save current script variable values to prefs
Usage: /save
Note: prefs are sorted in the file LSD Prefs in your preferences
folder
CREDITS
The SLF gives credit to the following people:
Yagrmstr for portions of the xl command.
Plugs for portions of the plist command.
Wayne K. Walrath for ACME Script Widgets 2.5.1.
Evan Vetere for portions of the f command.
SMWGod for script advertising.
Troll-man for portions of LSD 2.0 Blue.
DISCLAIMER
The SLF assumes no resposibility for anything that occurs as a result of using this script. If you want to be an asshole with it go right ahead just dont blame us when someone decides to do something about it.
The script is intentionally saved non read-only so that you can assure yourself that no malicious code is included.
USAGE AND LIMITATIONS
LSD is copyright 1996 by the SLF. Permission is granted to use this code to produce your own scripts (we think that people who save scrips as run only are fucking LAME. How the fuck do we know you aren't going to delete our hd's?) so long as full credit is given to the SLF.
OB SCRIPTING NOTES
Ob Scripting Note I: Where do you think the guy who writes caffeine got the idea to name his script after a drug? Gee, I fucking wonder.
Ob Scripting Note II: Where do you think the guy who writes caffeine got the idea to use the ACME Script Widgets? Gee, I fucking wonder.
Ob Scripting Note III:
Excerpted from the Caffeine Installer Read Me by Rixter:
WARNING: Before installing this revision of Caffeine Find and trash ALL versions of Caffeine, Offerbot, and LSD you posess... OTHER scripts MAY contain VIRUSES that interfere with Caffeine! OLD Caffeine versions on your DISKS can interfere with this install!
Gee, with the fucking source code sitting right in front of him you think he could check for this sort of thing before running his fucking mouth off. Perhaps he's too clueless to understand the LSD source enough to realize its in no way malicious. In fact, though he claims that Caffeine isn't mailicious and has no back doors, he refuses to allow anyone to view the Caffeine source code so they can have no doubt in their mind of his claim. Obviously if he's not allowing anyone to view the code, he has something to hide.
Note: We won't get into his horrific spelling at this point.
